Get Destination

Route

/v2/streaming/destinations/{destination_id}

Description

Retrieve detailed information about a specific streaming destination, including configuration and status.

Method

GET

Inputs

Parameter	Type	Required	Description
destination_id	string	Yes	Unique identifier of the destination to retrieve

Path Parameters

• destination_id: The unique identifier of the destination (provided in the URL path)

Request Example

GET /v2/streaming/destinations/dest-123

Output

Field	Type	Description
id	string	Unique destination identifier
name	string	Destination name
description	string	Destination description
type	string	Destination type (always "https")
format	string	Data format (json, json_lines)
encoding	string	Encoding type (none, gzip)
https_config	object	HTTPS configuration details
status	string	Destination status (active, inactive, error)
last_activity	string	Last successful data transmission (ISO 8601)
created_at	string	Creation timestamp (ISO 8601)
updated_at	string	Last update timestamp (ISO 8601)

HTTPS Config Object

Field	Type	Description
uri	string	HTTPS endpoint URL
timeout_seconds	integer	Request timeout in seconds
headers	object	Custom HTTP headers (sensitive values masked)

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "id": "dest-123",
  "name": "SIEM Integration",
  "description": "Stream to Splunk SIEM",
  "type": "https",
  "format": "json_lines",
  "encoding": "gzip",
  "https_config": {
    "uri": "https://splunk.company.com/services/collector/event",
    "timeout_seconds": 60,
    "headers": {
      "Authorization": "***masked***"
    }
  },
  "status": "active",
  "last_activity": "2024-01-15T11:30:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Usage Notes

• Sensitive header values (like authorization tokens) are masked in the response
• Status indicates current operational state of the destination
• last_activity shows when data was last successfully transmitted